Jackson একটি জনপ্রিয় লাইব্রেরি যা JSON Serialization এবং Deserialization করতে ব্যবহৃত হয়। JSON ডেটার সঠিক এবং কার্যকর প্রক্রিয়াকরণের জন্য Jackson অ্যানোটেশনগুলি কার্যকরভাবে ব্যবহার করা দরকার। এই নিবন্ধে, Serialization এবং Deserialization প্রক্রিয়াগুলির জন্য Best Practices নিয়ে আলোচনা করা হয়েছে যা আপনার কোডকে আরও কার্যকর এবং নির্ভুল করবে।
1. @JsonProperty এর সঠিক ব্যবহার
@JsonProperty অ্যানোটেশন ব্যবহার করে আপনি JSON ফিল্ডের নাম এবং Java ফিল্ড এর নামের মধ্যে পার্থক্য তৈরি করতে পারেন, যাতে camelCase এবং snake_case বা অন্যান্য নামকরণ পদ্ধতির মধ্যে সামঞ্জস্য বজায় থাকে।
Best Practice:
- JSON এর নাম এবং Java ফিল্ডের নাম ভিন্ন হলে
@JsonPropertyব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonProperty;
public class Person {
@JsonProperty("full_name")
private String name;
@JsonProperty("age_in_years")
private int age;
// Constructor, Getters and Setters
}
JSON Output:
{
"full_name": "John Doe",
"age_in_years": 30
}
2. @JsonIgnore এবং @JsonIgnoreProperties ব্যবহার
Jackson ডিফল্টভাবে সমস্ত public ফিল্ড এবং getter/setter মেথডকে সিরিয়ালাইজ করে। কিন্তু অনেক সময় কিছু ফিল্ডকে Serialization এবং Deserialization থেকে বাদ দেওয়া প্রয়োজন।
Best Practice:
@JsonIgnore: যদি কোনো নির্দিষ্ট ফিল্ডকে Serialization/Deserialization থেকে বাদ দিতে চান।@JsonIgnoreProperties: একাধিক ফিল্ডকে একই সাথে বাদ দিতে চান।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonIgnore;
public class Person {
private String name;
@JsonIgnore
private String password; // Do not serialize the password field
// Constructor, Getters and Setters
}
JSON Output:
{
"name": "John Doe"
}
3. @JsonFormat ব্যবহার করে Date/Time Formatting
@JsonFormat অ্যানোটেশনটি Date এবং Time ফরম্যাট কাস্টমাইজ করতে ব্যবহৃত হয়।
Best Practice:
- Date/Time ফিল্ড কাস্টম ফরম্যাটে Serialization এবং Deserialization করার জন্য
@JsonFormatব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonFormat;
import java.util.Date;
public class Event {
private String name;
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
private Date eventDate;
// Constructor, Getters and Setters
}
JSON Output:
{
"name": "Conference",
"eventDate": "2024-12-21 10:00:00"
}
4. @JsonIgnoreProperties ব্যবহার করে Unknown Properties Handling
JSON ফাইল থেকে ডেটা Deserialization করার সময় যদি JSON এর মধ্যে কোনো অজানা প্রপার্টি থাকে যা আপনার Java ক্লাসে নেই, তবে Jackson ডিফল্টভাবে UnrecognizedPropertyException throw করবে। এই ধরনের সমস্যার সমাধানে @JsonIgnoreProperties ব্যবহার করুন।
Best Practice:
@JsonIgnoreProperties(ignoreUnknown = true)ব্যবহার করে অজানা প্রপার্টি উপেক্ষা করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
@JsonIgnoreProperties(ignoreUnknown = true)
public class Person {
private String name;
private int age;
// Constructor, Getters and Setters
}
JSON Input (with unknown property):
{
"name": "John Doe",
"age": 30,
"address": "1234 Elm St" // unknown property
}
JSON Output:
{
"name": "John Doe",
"age": 30
}
5. @JsonCreator এবং @JsonProperty দিয়ে Constructor Injection
Jackson ডিফল্টভাবে default constructors ব্যবহার করে JSON ফিল্ডগুলির মান ইনজেক্ট করে। তবে, আপনি constructor injection ব্যবহার করতে চাইলে @JsonCreator এবং @JsonProperty অ্যানোটেশন ব্যবহার করুন।
Best Practice:
- Constructor Injection এর মাধ্যমে ফিল্ডের মান ইনজেক্ট করার জন্য
@JsonCreatorএবং@JsonPropertyব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.annotation.JsonProperty;
public class Person {
private String name;
private int age;
@JsonCreator
public Person(@JsonProperty("name") String name, @JsonProperty("age") int age) {
this.name = name;
this.age = age;
}
// Getters
}
JSON Input:
{
"name": "John Doe",
"age": 30
}
JSON Output:
{
"name": "John Doe",
"age": 30
}
6. @JsonAutoDetect দিয়ে Field Visibility কনফিগার করা
Jackson ডিফল্টভাবে private ফিল্ডগুলোকে Serialization এবং Deserialization-এর সময় সিরিয়ালাইজ করে না। আপনি @JsonAutoDetect ব্যবহার করে visibility কাস্টমাইজ করতে পারেন।
Best Practice:
- Field visibility কাস্টমাইজ করার জন্য
@JsonAutoDetectব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonAutoDetect;
import com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility;
@JsonAutoDetect(fieldVisibility = Visibility.ANY, getterVisibility = Visibility.NONE)
public class Person {
private String name;
// Constructor, Getters and Setters
}
JSON Output:
{
"name": "John Doe"
}
7. @JsonIdentityInfo ব্যবহার করে Circular References Handling
Circular References সমাধান করার জন্য @JsonIdentityInfo ব্যবহার করতে পারেন। এটি অবজেক্টের unique identifier ব্যবহার করে circular references এড়াতে সহায়তা করে।
Best Practice:
- Circular References এড়ানোর জন্য
@JsonIdentityInfoব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonIdentityInfo;
import com.fasterxml.jackson.annotation.ObjectIdGenerators;
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Person {
private int id;
private String name;
private Address address;
// Constructor, Getters and Setters
}
public class Address {
private int id;
private String street;
private Person person;
// Constructor, Getters and Setters
}
8. Exception Handling
Serialization এবং Deserialization-এ errors বা exceptions handling করা একটি গুরুত্বপূর্ণ Best Practice। Jackson এর JsonParseException, JsonMappingException ব্যবহার করে আপনি error handling করতে পারেন।
Best Practice:
- Jackson exceptions handle করার জন্য try-catch ব্লক ব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.core.JsonParseException;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JsonExceptionHandlingExample {
public static void main(String[] args) {
String invalidJson = "{name: 'John Doe'}"; // Invalid JSON (missing quotes around field names)
ObjectMapper objectMapper = new ObjectMapper();
try {
objectMapper.readValue(invalidJson, Person.class);
} catch (JsonParseException e) {
System.out.println("Invalid JSON format: " + e.getMessage());
} catch (Exception e) {
e.printStackTrace();
}
}
}
9. Use @JsonView for Field-based Filtering
Jackson-এ @JsonView ব্যবহার করে আপনি JSON filtering করতে পারেন, যেখানে একটি নির্দিষ্ট ভিউ দ্বারা নির্ধারিত ফিল্ডগুলি কেবলমাত্র JSON আউটপুটে অন্তর্ভুক্ত হবে।
Best Practice:
- Conditional serialization এর জন্য
@JsonViewব্যবহার করুন।
উদাহরণ:
import com.fasterxml.jackson.annotation.JsonView;
public class Person {
@JsonView(Views.Public.class)
private String name;
@JsonView(Views.Internal.class)
private String password;
// Constructor, Getters and Setters
}
class Views {
public static class Public {}
public static class Internal extends Public {}
}
Jackson এর মাধ্যমে JSON Serialization এবং Deserialization-এর সময় Best Practices অনুসরণ করা কোডকে আরও পরিষ্কার, নির্ভুল এবং কার্যকরী করে তোলে। গুরুত্বপূর্ণ Best Practices:
@JsonPropertyএবং@JsonAutoDetectব্যবহার করে visibility কাস্টমাইজ করা।- Exception Handling এবং
@JsonViewব্যবহার করে নির্দিষ্ট ক্ষেত্রগুলো কাস্টমাইজ করা। - Circular references এড়াতে
@JsonIdentityInfoব্যবহার করা।
এগুলি আপনাকে Jackson কে আরও দক্ষতার সাথে ব্যবহার করতে সাহায্য করবে।
Read more
